Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Movie Posters and Movie Previews

SetPosterBox

You can use the SetPosterBox function to set a poster's boundary rectangle. You define the poster's image by specifying a time in the movie (use the SetMoviePosterTime function, described on page 2-105). You specify the size and position of the poster image with this function.

pascal void SetPosterBox (Movie theMovie, const Rect *boxRect);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

boxRect

Contains a pointer to a rectangle. The Movie Toolbox sets the poster's boundary rectangle to the coordinates specified in the structure referred to by this parameter.

DESCRIPTION

If you do not specify a boundary rectangle for the poster, the Movie Toolbox uses the movie's matrix when it displays the poster.

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
invalidRect	-2036	Specified rectangle has invalid coordinates

SEE ALSO

Your application can retrieve a poster's boundary rectangle by calling the GetPosterBox function, which is described in the next section.